home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / gt_power / whou320.zip / SCANMAIL.DOC < prev    next >
Text File  |  1989-08-13  |  4KB  |  126 lines
  1.  
  2.  
  3.                      SCANMAIL - A utility for GT SYSOPS
  4.  
  5.         REVISION HISTORY.
  6.  
  7.                 v1.00  - 12/4/89 - First public release
  8.                 v2.00  - 8/8/89  - LAN awareness added
  9.                                  - new WAITING.CTL format
  10.                 v2.01  - 13/8/89 - removed clear function from SCANMAIL
  11.                                  - put clear into CLRMAIL
  12.  
  13.         FUNCTION.
  14.  
  15.                 SCANMAIL is a batch file utility which will allow you
  16.                 to force a response to the "Read personal Mail" prompt
  17.                 in GT.
  18.  
  19.                 CLRMAIL now performs the clear function that SCANMAIL
  20.                 v2.00 used to do. The command-line syntax for CLRMAIL
  21.                 is identical to that for SCANMAIL.
  22.  
  23.  
  24.         USAGE.
  25.  
  26.                 Place the command
  27.  
  28.                 SCANMAIL  [/Lxxxxxxx]
  29.  
  30.                 in your GTLOGON.BAT and SCANMAIL
  31.                 will scan the WAITING.CTL (as created by WHOYOU) to
  32.                 see if the user has any mail waiting.
  33.  
  34.                 If the name in the GTUSER.BBS matches an entry in the
  35.                 WAITING.CTL SCANMAIL will exit with ERRORLEVEL set to 1
  36.                 otherwise ERRORLEVEL will be set to 0.
  37.  
  38.                                    *** NOTE ***
  39.  
  40.                 This version of SCANMAIL will *ONLY* work with the
  41.                 WAITING.CTL file created by WHOYOU v3.00 or later!
  42.  
  43.                 ** NOTE **
  44.  
  45.                 With this release of SCANMAIL you must ALSO place the
  46.                 command
  47.  
  48.                 CLRMAIL  [/Lxxxxxxx]
  49.  
  50.                 in the GTLOGOFF.BAT to clear the "mail waiting" flag.
  51.  
  52.                 The /L parameter format is identical to the SCANMAIL
  53.                 parameter (and indeed MUST be the same!)
  54.  
  55.  
  56.         ERRORLEVEL EXITS.
  57.  
  58.                 00 - normal exit - NO mail found
  59.                 01 - normal exit - user HAS mail
  60.                 02 - ERROR - GTUSER.BBS not found or in error
  61.                 03 - ERROR - WAITING.CTL not found or in error
  62.                 04 - ERROR - write error on WAITING.CTL
  63.  
  64.  
  65.         COMMAND-LINE PARAMETERS.
  66.  
  67.                 SCANMAIL and CLRMAIL have ONE optional command-line parameter.
  68.                 This is ONLY used if you are running multiple nodes
  69.                 in a LAN environment.
  70.  
  71.                 /Lxxxxxxx - Drive\Path of your LAN path for GT.
  72.  
  73.                             This is the drive\pathname that you have
  74.                             defined in the LR= line in your GT.CNF
  75.  
  76.                 All parameters must be uppercase.
  77.  
  78.                 /LC:\MYDIR is valid
  79.  
  80.                 /lC:\MYDIR is NOT.
  81.  
  82.  
  83.         EXAMPLES.
  84.  
  85.                 SCANMAIL
  86.  
  87.                 Scans WAITING.CTL in the GTPATH= directory.
  88.  
  89.                 SCANMAIL /LC:\MYLAN
  90.  
  91.                 Scans WAITING.CTL in the C:\MYLAN directory.
  92.  
  93.                 CLRMAIL
  94.  
  95.                 Clears the mail-waiting flag for the last user in the
  96.                 WAITING.CTL in the GTPATH= directory
  97.  
  98.                 Please see the enclosed GTLOGON.DEM file for a sample
  99.                 GTLOGON.BAT.
  100.  
  101.         FURTHER INFORMATION.
  102.  
  103.                 Please send all comments/suggestions/bugs to
  104.  
  105.                              Ken Thompson
  106.                              164 Lyons Rd.
  107.                               Drummoyne
  108.                              Sydney N.S.W.
  109.                              Australia 2047
  110.  
  111.                              +61-2-81-4751
  112.  
  113.                              or via my BBS
  114.  
  115.                             The Black Hole
  116.                           GT Net/Node 302/002
  117.  
  118.                            +61-2-819-6971 (2400 NO CRASH!mail)
  119.  
  120.                             The Black Hole
  121.                           GT Net/Node 302/003
  122.  
  123.                            +61-2-719-8161 (9600 CRASH!able)
  124.  
  125.  
  126.